home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / drv_priv.z / drv_priv
Encoding:
Text File  |  2002-10-03  |  3.2 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ddddrrrrvvvv____pppprrrriiiivvvv((((DDDD3333))))                                                      ddddrrrrvvvv____pppprrrriiiivvvv((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _dddd_rrrr_vvvv______pppp_rrrr_iiii_vvvv - determine whether credentials are privileged
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _iiii_nnnn_tttt _dddd_rrrr_vvvv______pppp_rrrr_iiii_vvvv_((((_cccc_rrrr_eeee_dddd______tttt _****_c_r_p_))))_;;;;
  13.  
  14.    AAAArrrrgggguuuummmmeeeennnnttttssss
  15.      _c_r_p       Pointer to the user credential structure.
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      The _dddd_rrrr_vvvv______pppp_rrrr_iiii_vvvv function determines whether the credentials specified by the
  19.      credential structure pointed to by _c_r_p identify a privileged process.
  20.  
  21.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  22.      _dddd_rrrr_vvvv______pppp_rrrr_vvvv returns 0 if the specified credentials identify a privileged
  23.      process or contain CAP_DEVICE_MGT capability, otherwise, _EEEE_PPPP_EEEE_RRRR_MMMM returned.
  24.  
  25. UUUUSSSSAAAAGGGGEEEE
  26.      This function should only be used when file access modes and special
  27.      minor device numbers are insufficient to provide the necessary protection
  28.      for the driver operation being performed.  Calls to _dddd_rrrr_vvvv______pppp_rrrr_iiii_vvvv should
  29.      replace all calls to _ssss_uuuu_ssss_eeee_rrrr and any explicit checks for effective user ID
  30.      equal to zero in driver code.
  31.  
  32.      A credential structure pointer is passed into various driver entry point
  33.      functions [_oooo_pppp_eeee_nnnn(D2), _cccc_llll_oooo_ssss_eeee(D2), _rrrr_eeee_aaaa_dddd(D2), _wwww_rrrr_iiii_tttt_eeee(D2), and _iiii_oooo_cccc_tttt_llll(D2)] and
  34.      can also be obtained by calling _dddd_rrrr_vvvv______gggg_eeee_tttt_pppp_aaaa_rrrr_mmmm(D3) from base level driver
  35.      code.
  36.  
  37.    LLLLeeeevvvveeeellll
  38.      Base or Interrupt.
  39.  
  40.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  41.      Does not sleep.
  42.  
  43.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  44.      across calls to this function.
  45.  
  46.    WWWWaaaarrrrnnnniiiinnnnggggssss
  47.      The only valid use for a credential structure pointer is as an argument
  48.      to _dddd_rrrr_vvvv______pppp_rrrr_iiii_vvvv.  The contents of a credential structure are not defined by
  49.      the DDI/DKI and a driver may not examine the contents of the structure
  50.      directly.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.